home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / utils3 / filer / !Filer- / !Help next >
Text File  |  1995-02-07  |  11KB  |  264 lines
  1.  
  2.  
  3. !Filer- , version 2.2
  4. ---------------------
  5.  
  6.  
  7. What is it
  8. ==========
  9.  
  10. 'Filer' in its name tells you that it's a kind of a filer
  11. '-'     in its name tells you that it's less than a filer
  12.  
  13. Like the Filer it allows you to 'walk' through the directory tree
  14. of a filing system and manipulate objects.
  15.  
  16. Unlike the Filer it does the first very quickly because it's 'menu driven',
  17. but is not very good at the latter - it only Filer_Run's objects which means
  18. that files can be run and loaded and directories opened; you still need the
  19. 'right' Filer to change file types, stamp files etc.
  20.  
  21.  
  22. How to use it
  23. =============
  24.  
  25. There are four ways of getting a Filer- menu:
  26.  
  27. • If a Filer window is displaying the contents of some directory,
  28.   - position the pointer over the window and click MENU while holding
  29.     down the Alt key (either the left or the right one)
  30.   - position the pointer over the window's the title bar and click MENU
  31.     (users of MouseAxess, please read 'Problems')
  32.  
  33.   The menu that appears shows the contents of the displayed directory
  34.   and looks like
  35.  
  36.   +============+
  37.   |  dir name  |  the menu title is the name of the displayed directory
  38.   +============+
  39.   |    Up    ⇨ |  leads to its parent dir or to the 'FS::Disc' submenu
  40.   +------------+
  41.   | some dir ⇨ |  go right to get further down the tree or click to open
  42.   | some file  |  click to run/load somewhere
  43.   |   etc...   |
  44.  
  45.   If you're in the root directory ('dir name' = $ ), there's no parent and
  46.   so 'Up' leads to a 1-item submenu named 'FS::Disc' holding the name
  47.   of the Filing System and the name/number of the Disc the dir is 'on'.
  48.  
  49. • Click ADJUST over any of the FS Filers (eg ADFS floppy, RAMFS).
  50.   You get a menu similar to the above for the root directory of the device.
  51.   The ResourceFS is an exception: here you get the menu for Resources:$.Apps,
  52.   just like when you click SELECT over the Apps icon.
  53.  
  54. • Click MENU over the Pinboard.
  55.   Filer-'s 'PinBoard menu' appears:
  56.  
  57.   +==========+
  58.   |  Filer-  |  menu title
  59.   +==========+
  60.   | Floppy ⇨ |  leads to ADFS::0.$
  61.   | HDrive ⇨ |           IDEFS::4.$
  62.   | RAMFS  ⇨ |           RAM:$
  63.   | Apps   ⇨ |           Resources:$
  64.   | MemFS  ⇨ |           MemFS:$
  65.   +----------+
  66.  
  67.   This is customisable and is described in !Filer-.PinBrdMenu.!Help,
  68.   but in short: you must provide a list of devices you want Filer-
  69.   to 'support' and a sprite for each device. If you supply two sprites,
  70.   "device" and "device'", the latter will be used by the Wimp to show
  71.   the device is 'selected'. 2click on !Make to make the PinBoard menu.
  72.  
  73.   If a filing system from Filer-'s PinBoard menu isn't present and you
  74.   follow the ⇨ in 'its' menu entry, Filer- will open a submenu with
  75.   a greyed out 'Not present' entry.
  76.  
  77.   The behaviour of Filer- on a MENU click over the Pinboard is determined
  78.   by a module titled 'FiPiFi' (FIler PInboard FIlter) and located in
  79.   !Filer-.PinBrdMenu under the names Alt_No and Alt_Yes:
  80.  
  81.   If Alt_No is being used you get Filer-'s PinBoard menu when you
  82.   click MENU over the Pinboard window. The click won't be intercepted
  83.   if you hold down Alt or Shift.
  84.   
  85.   If Alt_Yes is being used you get the menu when you click MENU over the
  86.   Pinboard window AND are holding down the Alt key (either left or right).
  87.  
  88.   You tell Filer- which one to use in its !Run file (see there; it's easy)
  89.  
  90.  
  91. What can it do besides?
  92. =======================
  93.  
  94. • To get into an application directory
  95.   - click SELECT/ADJUST over its menu entry while holding down Shift.
  96.     (Clicks with ADJUST keep the menu alive, of course)
  97.   - use the 'missing hand' (a 'long SELECT click'):
  98.     click on an 'application item' with SELECT and hold the button down
  99.     for a while. A 'long ADJUST click' over an application-item in a
  100.     Filer- menu works not quite as expected (see 'Problems' below)
  101.  
  102. • If a 'normal' menu item is a directory, the icon won't invert when
  103.   the pointer's over it, but RiscPC's small_diro (o=open) sprite will
  104.   be displayed instead. (Low res small_diro is used. If you mostly work
  105.   in a high resolution mode, replace !Filer-.PinBrdMenu.Sprites.small_diro
  106.   with !Filer-.small_diro.high res, but don't forget to rename it. If you
  107.   are a RiscPC, you can delete small_diro from !Filer-.PinBrdMenu.Sprites)
  108.  
  109. • When the Filer- menu gets deeper than 8 (submenus) and RISC OS complains
  110.   about 'Too menu menus', the first 8 subs are discarded and a new tree is
  111.   started with the 9th submenu as the root.
  112.  
  113. • If a submenu has the 'Up ⇨' item and you click over it with
  114.   - SELECT : the parent directory will be opened and the Filer- menu gone
  115.   - MENU   : only the menu of the parent directory will be created
  116.   - ADJUST : the parent directory will be opened and its menu built
  117.  
  118. • If you click MENU over the vertical/horizontal scroll bar of a window,
  119.   the slider will jump so that its upper/left-hand end will be (roughly)
  120.   aligned with the pointer and the window's contents scrolled appropriately.
  121.   This is very usefull with large documents that are slow to redraw and will
  122.   work with any application that has its work area origin in the upper left
  123.   corner. Many 'object based drawing programs' a la !Draw haven't so this
  124.   feature won't work with them, but !Draw is 'important' enough to get a
  125.   special treatment. Also it won't work with !Edit, cause !Edit does real
  126.   wild things to its work area (to implement its weird sliders).
  127.  
  128. • If the system variable Filer-$Options is defined and contains the
  129.   string '+center' then submenus will be positioned vertically centered
  130.   about the pointer:
  131.                                    | title
  132.                                    +---------+
  133.                                    | item x0 |
  134.                                    | ...     |
  135.                         | ...      | item xA |
  136.                         | item x ⇨ | item xB |
  137.                                  ^ | item xC |
  138.     pointer over the 'right' arrow | ...     |
  139.  
  140.   If you want the submenu to be built as usual ('item x0' at the same level
  141.   as 'item x'), ensure that '+center' doesn't occur in Filer-$Options
  142.  
  143. • If the system variable Filer-$Options is defined and contains the
  144.   string '+move' then, if a submenu is going to overlap the menu tree,
  145.   the whole of the Filer- menu will be moved left by an appropriate amount.
  146.   This feature is currently broken: after the menu has been moved, you can't
  147.   access objects from the new submenu or any other apart from the root. As
  148.   this isn't very useful, Filer-$Options shouldn't contain the string '+move'
  149.  
  150. • Quit from Task Manager
  151.  
  152. • Runs on a RiscPC (but isn't mentioned in !Products)
  153.  
  154.  
  155. Warning
  156. =======
  157.  
  158. If you RMKill FiPiFi and RMRun it again, the 'MENU over a Filer window's
  159. title bar' option may stop to work, when FiPiFi has changed it's position
  160. in the RMA. This is because FiPiFi holds a poll word for Filer-, whose
  161. address is calculated only once, when Filer- starts to run
  162.  
  163.  
  164. Problems
  165. ========
  166.  
  167. • When your Archi is very busy it can happen that the Filer- doesn't
  168.   'get' an ADJUST over a FS Filer icon (this often happens when you're
  169.   reading a DOS floppy). Just hold the button down for a while
  170.  
  171. • Some 'editor-applications' (even some by Acorn) conform to Acorn's guide
  172.   lines (or whatever it's called) and open the parent directory of a file
  173.   being edited when you close editor's window displaying the file by clicking
  174.   on the close icon with ADJUST (uff!). If you hold the button a tiny bit
  175.   longer than 'normal', Filer- catches the 'event' and doesn't let it through
  176.   to the Filer, ie. you don't get a display of the document's parent dir but
  177.   a Filer- menu of it instead. So if you want the directory displayed,
  178.   don't stick to ADJUST
  179.  
  180. • If the Filer/Pinboard died and you revived it
  181.   (*RMReinit Filer/Pinboard, *Desktop) but don't get the FS/pinboard menu,
  182.   issue a *RMReinit FiPiFi. Filer- listens for the TaskInitialise message
  183.   and does itselt the reinit when the Filer or the Pinboard restart, but
  184.   sometimes it doesn't work...
  185.  
  186. • A 'a long ADJUST click' over a Filer-'s menu application-item is expected to
  187.   - open the app's dir
  188.   - keep Filer-'s menu
  189.   Due to the way Filer- works, the 'open dir' message from a click with ADJUST
  190.   over a menu (application-)item is seen by the FiPiFi module as an ADJUST
  191.   click over an FS-Filer icon (on the icon bar) and sent to Filer-. And so,
  192.   when you long ADJUST click over an application-item, you get a menu similar
  193.   to the FS-Filer menus you get when you click ADJUST over an FS-Filer icon.
  194.  
  195.   I don't know whether there'll be problems if you're running other
  196.   'missing hand' providers concurrently with Filer-
  197.  
  198. • If you're using MouseAxess (like me), the Filer- menu you get on
  199.   MENU-click over the title bar icon of a Filer window disappears just
  200.   after it's been created. To overcome this, press MENU obove the
  201.   Filer window, just below the title bar, move the pointer up till it's
  202.   over the title bar and release the button.
  203.  
  204.  
  205. Tips for hackers
  206. ================
  207.  
  208. • Pointer's position over Filer-'s Pinboard menu
  209.   ----------------------------------------------
  210.   After you've got your Pinboard menu running you may want to change the
  211.   position of the pointer relative to it. In the original the menu pops up
  212.   so that the pointer is over the second item (cause it's my hard disc) close
  213.   to the right edge of the menu (to take off quickly). To change this, play
  214.   with the NUMBERS in
  215.                         x%-=120 : y%+=24
  216.   
  217.   in PROCmouseClick , line 259 (you don't need to know any BASIC to do that)
  218.  
  219. • Quick scroll for all
  220.   --------------------
  221.   If you want 'quick scroll' for !Draw+ and other drawing progs that
  222.   have the work area origin in the lower left-hand corner (!Vector surely
  223.   has), change the line
  224.  
  225.     IF D%=FNhandle("Draw") Q%!24=y%-56-Q%!8-Y% ELSE Q%!24=y%-56-Q%!16+Y%
  226.  
  227.   in PROCscroll into
  228.  
  229.     CASE D% OF
  230.      WHEN FNhandle("Draw"), FNhandle("Draw+"), FNhandle("Vector")
  231.       Q%!24=y%-56-Q%!8-Y%
  232.      OTHERWISE Q%!24=y%-56-Q%!16+Y%
  233.     ENDCASE
  234.  
  235.   The parameter for FNhandle is TaskManager's name of the task whose handle
  236.   you're looking for.
  237.  
  238. • Menu width on RiscPC
  239.   --------------------
  240.   On a RiscPC, when outline fonts are used, the menu width seems not
  241.   to be controllable by specifying items' width in the menu header and
  242.   so there's little I can do about it (well, now that my friend has
  243.   the PRMs I could, but it's a mess). But you can easily achieve that
  244.   the with of Filer-'s PinBoard menu is roughly what you want, because
  245.   it's static. Go to line 102 and play with FN12("Filer-") (FN12 truncates
  246.   its argument to 12 chars and inserts it into a menu header). If the
  247.   devices-sprites for the PinBoard menu aren't too wide, you can get a
  248.   nicer look by putting some spaces into "Filer-". With the supplied
  249.   sprites, I get a nice Filer- PinBoard menu with FN12(" Filer- ")
  250.  
  251. --
  252.  
  253. Enjoy !
  254.  
  255.  
  256. Franz Philipps
  257. Köslinerstr. 71a
  258. 76139 Karlsruhe
  259. Germany
  260.  
  261. or (for another couple of months)
  262.  
  263. ig06@rz.uni-karlsruhe.de
  264.